home *** CD-ROM | disk | FTP | other *** search
/ PsL Monthly 1993 December / PSL Monthly Shareware CD-ROM (December 1993).iso / prgmming / dos / pascal / iolog.com / IOLOG.DOC < prev    next >
Encoding:
Text File  |  1988-12-20  |  2.8 KB  |  59 lines
  1.  IOLOG - a TSR that logs all DOS disk I/O operations to a file for later
  2.  study.
  3.  
  4.  To install, type
  5.    IOLOG [LogFileName]
  6.  
  7.  The log file defaults to C:\IOLOG. This file is rewritten when the TSR goes
  8.  resident. If you use a different file, be sure to specify a complete path
  9.  name, since IOLOG opens and closes this file for each I/O operation. If you
  10.  haven't specified a complete path name and you change directories, you'll get
  11.  little log files scattered all over the place.
  12.  
  13.  The log file is a text file showing information about each interesting DOS
  14.  I/O call. It lists the call and then the associated file handle or name, as
  15.  available. If DOS detected an error during the call, column 9 of the report
  16.  shows an asterisk, unless reporting of failed calls is disabled. IOLOG does
  17.  not log its own I/O operations.
  18.  
  19.  IOLOG uses a buffer to hold log information until it is safe to write it to
  20.  disk. In the unexpected event that the buffer overflows before it can be
  21.  emptied, the log file will contain one or more lines showing just an
  22.  exclamation point.
  23.  
  24.  Certain aspects of IOLOG can be controlled by pressing hot keys after it has
  25.  gone resident. The following table summarizes the hot keys:
  26.  
  27.    <LeftShift><RightShift><L>     toggles logging            (default ON)
  28.    <LeftShift><RightShift><W>     toggles read/write logging (default OFF)
  29.    <LeftShift><RightShift><F>     toggles failure logging    (default ON)
  30.    <LeftShift><RightShift><C>     clears log file
  31.    <LeftShift><RightShift><U>     unloads IOLOG from memory
  32.  
  33.  When logging is off, no further I/O operations will be logged until it is
  34.  turned on again. Then any new operations will be appended to the existing log
  35.  file. The Read/Write toggle controls whether DOS functions $3F and $40 are
  36.  logged. In some cases, these calls are made quite often, and logging them
  37.  will both decimate the performance of any program that is running and also
  38.  create huge log files. The Failure toggle controls whether DOS calls with
  39.  errors are reported, e.g., a request to open a file that isn't found. If
  40.  failures are logged, they are denoted by an asterisk in column 9 of the log.
  41.  Otherwise, failing calls do not appear at all.
  42.  
  43.  IOLOG uses sound effects to let you know whether you're toggling a feature on
  44.  or off. When you toggle something ON, a rising sequence of tones sounds. OFF,
  45.  and a falling sequence is used. When you clear the log file, you get a muddy
  46.  sounding warble. And "taps" plays when you successfully unload IOLOG from
  47.  memory.
  48.  
  49.  IOLOG uses about 19K of memory while installed.
  50.  
  51.  Requires Turbo Professional to compile.
  52.  Released to the public domain.
  53.  
  54.  Written by Kim Kokkonen, TurboPower Software
  55.  Thanks to Don Pearsall for providing the impetus to write this program.
  56.  
  57.  Version 1.0 - 12/16/88
  58.    initial release
  59.